package cn.b.sky.schedule.service;

import cn.b.sky.common.model.Page;
import cn.b.sky.schedule.model.TimeJobInfoCondition;
import cn.b.sky.schedule.model.TimedJobInfo;

import java.util.List;

/**
 * 
 * <strong>Title : TimedJobService.java<br></strong>
 * <strong>Package : cn.b.sky.schedule.service<br></strong>
 * <strong>Description : </strong>定时任务服务接口<br> 
 * <strong>Create on : 2016-3-18 上午9:54:35<br></strong>
 * <p>
 * @author lidapeng<br>
 * @version <strong>v1.0.0</strong><br>
 * <br>
 * <strong>修改历史:</strong><br>
 * 修改人 | 修改日期 | 修改描述<br>
 * -------------------------------------------<br>
 * <br>
 * <br>
 */
public interface TimedJobService {

  /**
   * 
   * 分页查询定时任务列表
   * @param timedJobInfo
   * @return
   */
  Page selectTimedJobList(TimeJobInfoCondition timedJobInfo);

  /**
   * 
   * 查询某种状态的任务
   * @param timedJobInfo
   * @return
   */
  List<TimedJobInfo> selectEnableTimedJob(int enable);

  /**
   * 根据编号查询任务
   * @param jobCode
   * @return
   */
  TimedJobInfo selectTimedJob(String jobCode);

  /**
   * 
   * <strong>Title : doEnableTimedJob<br></strong>
   * <strong>Description : </strong>启用任务<br> 
   * <strong>Create on : 2016-3-18 上午9:56:00<br></strong>
   * <p>
   * @param timedJobInfo
   * void
   * @throws 
   * @author lidapeng<br>
   * @version <strong>v1.0.0</strong><br>
   * <br>
   * <strong>修改历史:</strong><br>
   * 修改人 | 修改日期 | 修改描述<br>
   * -------------------------------------------<br>
   * <br>
   * <br>
   */
  void doEnableTimedJob(TimedJobInfo timedJobInfo);

  /**
   * 
   * <strong>Title : doDisableTimedJob<br></strong>
   * <strong>Description : </strong>停用任务<br> 
   * <strong>Create on : 2016-3-18 上午9:55:51<br></strong>
   * <p>
   * @param timedJobInfo
   * void
   * @throws 
   * @author lidapeng<br>
   * @version <strong>v1.0.0</strong><br>
   * <br>
   * <strong>修改历史:</strong><br>
   * 修改人 | 修改日期 | 修改描述<br>
   * -------------------------------------------<br>
   * <br>
   * <br>
   */
  void doDisableTimedJob(TimedJobInfo timedJobInfo);

  /**
   * 
   * <strong>Title : updateTimedConfig<br></strong>
   * <strong>Description : </strong>修改定时任务<br> 
   * <strong>Create on : 2016-3-18 上午9:55:32<br></strong>
   * <p>
   * @param timedJobInfo
   * void
   * @throws 
   * @author lidapeng<br>
   * @version <strong>v1.0.0</strong><br>
   * <br>
   * <strong>修改历史:</strong><br>
   * 修改人 | 修改日期 | 修改描述<br>
   * -------------------------------------------<br>
   * <br>
   * <br>
   */
  void updateTimedConfig(TimedJobInfo timedJobInfo);

  /**
   * 
   * <strong>Title : doExecuteTimedJob<br></strong>
   * <strong>Description : </strong>执行任务<br> 
   * <strong>Create on : 2016-3-18 上午9:55:19<br></strong>
   * <p>
   * @param timedJobInfo
   * void
   * @throws 
   * @author lidapeng<br>
   * @version <strong>v1.0.0</strong><br>
   * <br>
   * <strong>修改历史:</strong><br>
   * 修改人 | 修改日期 | 修改描述<br>
   * -------------------------------------------<br>
   * <br>
   * <br>
   */
  void doExecuteTimedJob(TimedJobInfo timedJobInfo) throws Exception;

  /**
   * 
   * <strong>Title : updateLastExecTime<br></strong>
   * <strong>Description : </strong>更新执行时间<br> 
   * <strong>Create on : 2016-3-18 上午9:55:00<br></strong>
   * <p>
   * @param jobCode
   * void
   * @throws 
   * @author lidapeng<br>
   * @version <strong>v1.0.0</strong><br>
   * <br>
   * <strong>修改历史:</strong><br>
   * 修改人 | 修改日期 | 修改描述<br>
   * -------------------------------------------<br>
   * <br>
   * <br>
   */
  void updateLastExecTime(String jobCode);

  /**
   * 
   * <strong>Title : saveTimedConfig<br></strong>
   * <strong>Description : </strong>保存<br> 
   * <strong>Create on : 2015-9-15 下午6:22:54<br></strong>
   * <p>
   * @param timedJobInfo
   * void
   * @throws 
   * @author lidapeng<br>
   * @version <strong>v1.0.0</strong><br>
   * <br>
   * <strong>修改历史:</strong><br>
   * 修改人 | 修改日期 | 修改描述<br>
   * -------------------------------------------<br>
   * <br>
   * <br>
   */
  void saveTimedConfig(TimedJobInfo timedJobInfo);
  
  /**
   * <strong>Title : checkTimedJob<br></strong>
   * <strong>Description : </strong>根据作业编号查看是否存在<br> 
   * <strong>Create on : 2016-6-21 下午2:00:56<br></strong>
   * <p>
   * @param jobCode
   * @return
   * boolean
   * @throws 
   * @author dapeng.li<br>
   * @version <strong>v1.0.0</strong><br>
   * <br>
   * <strong>修改历史:</strong><br>
   * 修改人 | 修改日期 | 修改描述<br>
   * -------------------------------------------<br>
   * <br>
   * <br>
   */
  boolean checkTimedJob(String jobCode);

  /**
   * 
   * <strong>Title : deleteTimedJob<br></strong>
   * <strong>Description : </strong>删除定时任务<br> 
   * <strong>Create on : 2016-6-24 下午3:02:51<br></strong>
   * <p>
   * @param jobCode
   * void
   * @throws 
   * @author lidapeng<br>
   * @version <strong>v1.0.0</strong><br>
   * <br>
   * <strong>修改历史:</strong><br>
   * 修改人 | 修改日期 | 修改描述<br>
   * -------------------------------------------<br>
   * <br>
   * <br>
   */
  void deleteTimedJob(String jobCode);

}
